
    <!DOCTYPE html>
    <html lang="zh-CN">
    <head>
      <meta charset="UTF-8">
      <meta name="viewport" content="width=device-width, initial-scale=1.0">
      <title>如何让你的 WebService 更易维护 - 学习卡片</title>
      <style>
        body { font-family: sans-serif; background-color: #f0f8ff; color: #333; display: flex; flex-direction: column; align-items: center; padding: 50px 20px; }
        .header h1 { font-size: 32px; }
        .grid-container { display: grid; grid-template-columns: repeat(3, 1fr); gap: 28px; width: 100%; max-width: 1200px; }
        .card-container { perspective: 1200px; cursor: pointer; height: 250px; }
        .card { width: 100%; height: 100%; position: relative; transform-style: preserve-3d; transition: transform 0.7s; border-radius: 16px; box-shadow: 0 4px 16px rgba(0,0,0,0.08); }
        .card-container.flipped .card { transform: rotateY(180deg); }
        .card-face { position: absolute; width: 100%; height: 100%; backface-visibility: hidden; display: flex; flex-direction: column; box-sizing: border-box; border-radius: 16px; background-color: #fff; padding: 24px; }
        .card-back { background-color: #f0fff4; transform: rotateY(180deg); justify-content: space-between; }
        .card-category { font-size: 14px; color: #0052d9; margin-bottom: 8px; font-weight: 500; }
        .card-question { font-size: 20px; font-weight: 500; flex-grow: 1; display: flex; align-items: center; justify-content: center; text-align: center; }
        .card-answer-wrapper { flex-grow: 1; overflow-y: auto; }
        .card-answer { font-size: 15px; line-height: 1.7; }
        .card-footer { font-size: 13px; color: #8a919f; border-top: 1px solid #f0f0f0; padding-top: 16px; margin-top: 16px; }
        .card-source { font-size: 13px; color: #8a919f; border-top: 1px solid #f0f0f0; padding-top: 12px; margin-top: 12px; }
      </style>
    </head>
    <body>
      <div class="header">
        <h1>如何让你的 WebService 更易维护 - 学习卡片</h1>
      </div>
      <div class="grid-container">
        
    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">技术</div>
          <div class="card-question">在选择WebService类型时，SOAP和RESTful分别适用于哪些不同的应用场景？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">技术</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">RESTful WebService推荐用于微服务架构和前后端分离项目，因为它具有更好的扩展性和性能。而SOAP WebService因其内置了更强的安全性和事务支持，可能是金融、政府系统的更好选择。</div>
          </div>
          <div class="card-source">来源: 1.1 选择合适的 WebService 类型</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">模式</div>
          <div class="card-question">文档中推荐的WebService分层架构是什么？每个层次分别承担什么职责？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">模式</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">推荐采用MVC（Controller-Service-Repository）分层架构。Controller层负责接收请求并调用Service层，Service层处理具体的业务逻辑，Repository层则负责数据库的访问。</div>
          </div>
          <div class="card-source">来源: 1.2 采用分层架构</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">规范</div>
          <div class="card-question">为了在升级WebService时不影响旧版本用户，文档推荐了哪种API版本控制方法？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">规范</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">文档推荐使用URL版本控制。通过在URL中加入版本号（例如 `/api/v1/users` 和 `/api/v2/users`），可以在不影响老版本API的情况下，逐步迁移到新的API版本。</div>
          </div>
          <div class="card-source">来源: 2.1 统一 API 版本管理</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">规范</div>
          <div class="card-question">根据RESTful设计规范，获取、创建、更新和删除用户的API端点应该如何设计？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">规范</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">应该使用HTTP方法结合资源名来设计：GET /users/{id} 用于获取用户；POST /users 用于创建用户；PUT /users/{id} 用于更新用户；DELETE /users/{id} 用于删除用户。规范强调不应在URL中使用动词（如/getUser）。</div>
          </div>
          <div class="card-source">来源: 2.2 规范 API 命名</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">机制</div>
          <div class="card-question">在Spring框架中，应如何实现统一的WebService异常处理，以避免向客户端暴露堆栈信息？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">机制</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">可以使用 `@RestControllerAdvice` 注解的类来统一处理异常。通过在该类的方法上使用 `@ExceptionHandler` 注解捕获特定异常（如NotFoundException）或通用异常（如Exception），可以返回统一、友好的错误信息，而不是原始的堆栈信息。</div>
          </div>
          <div class="card-source">来源: 4.1 使用 @ControllerAdvice 统一异常处理</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">技术</div>
          <div class="card-question">文档中提到了哪些用于WebService认证与授权的技术或协议？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">技术</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">文档中提到了两种技术：基于JWT（JSON Web Token）进行用户身份验证，以及适用于开放API认证的OAuth2.0协议。</div>
          </div>
          <div class="card-source">来源: 5.2 认证与授权</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">理论</div>
          <div class="card-question">采用分层架构（如MVC）为WebService设计带来了哪些核心优势？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">理论</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">采用分层设计的核心优势是让WebService更易于扩展，同时能够降低代码的耦合度，从而提高代码的可维护性。</div>
          </div>
          <div class="card-source">来源: 1.2 采用分层架构</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">技术</div>
          <div class="card-question">文档推荐使用什么工具来生成和管理API文档？如何在Spring Boot项目中集成它？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">技术</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">文档推荐使用Swagger来生成在线API文档。在Spring Boot项目中，可以通过引入 `springdoc-openapi-starter-webmvc-ui` 依赖，并在Controller和相关方法上添加 `@Tag` 和 `@Operation` 等注解来自动生成文档。</div>
          </div>
          <div class="card-source">来源: 3.1 使用 Swagger 生成 API 文档</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">特性</div>
          <div class="card-question">除了认证与授权之外，文档还强调了哪一项基础且重要的WebService安全措施？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">特性</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">文档强调所有WebService访问都应强制使用HTTPS，以防止数据在传输过程中被中间人攻击。</div>
          </div>
          <div class="card-source">来源: 5.1 启用 HTTPS</div>
        </div>
      </div>
    </div>

      </div>
    </body>
    </html>
